home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / debugtx.arc / 00README.DOC < prev    next >
Encoding:
Text File  |  1991-08-11  |  12.6 KB  |  295 lines
  1. A86 assembler package   V3.09           August 13, 1987
  2. The entire package is Copyright (C)1986-1987 Eric Isaacson.
  3. All rights reserved.
  4.  
  5. For easier bulletin-board distribution, I have split this package 
  6. into three ARC files, A86V309A.ARC, A86V309B.ARC, and 
  7. A86V309C.ARC.  The first file contains enough to get you started; 
  8. you can evaluate the package and then download the second and 
  9. third files later on.  
  10.  
  11. PLEASE read Chapter 1 for legal terms and conditions, how to 
  12. register for the package, and the overview of the assembler.
  13.  
  14.  
  15. QUESTION: "I bought this assembler from XYZ Software House, that 
  16.   advertised great software for $5 per disk.  What's going on 
  17.   here?  Have I already bought an assembler, or what?" 
  18.  
  19. ANSWER: Well, no, not exactly.  You've bought a disk that has 
  20.   great software on it; you haven't bought the software yet.  
  21.   A86, like the vast majority of software offered by the $5-per-
  22.   disk distribution houses, is free-distribution software (also 
  23.   known as "shareware", or "user-supported software").  That 
  24.   means I retain the right to A86, but I choose to let people 
  25.   pass it around.  I have no business relationship with any 
  26.   distribution houses; I don't get a penny of the $5 (or 
  27.   whatever) you paid them for the disk containing A86.  So I need 
  28.   and expect to be paid by you, because I'm trying to make a 
  29.   living out of making and supporting shareware products. 
  30.  
  31.   Many distribution houses do a pretty poor job of revealing the 
  32.   shareware nature of the software they sell.  If you thought you 
  33.   had purchased the software free and clear, you might feel 
  34.   justified in being angry with them for having misled you.  And 
  35.   you might look around for houses that do a better job of 
  36.   informing the public.  But I hope you'll take the time to 
  37.   consider everybody's role in the shareware marketing scene; if 
  38.   you do, I think you'll conclude that although you may have 
  39.   been misled, you haven't really been cheated out of anything. 
  40.  
  41.   Shareware is great for authors like me, who have spent all 
  42.   their years in their computer holes, learning to be great 
  43.   programmers, and no time in business school learning marketing 
  44.   and distribution techniques.  We simply cast our programs to 
  45.   the winds.  They are distributed at practically no cost to 
  46.   us.  That's why we can charge a lot less than the cost of 
  47.   "commercial" software. 
  48.  
  49.   Shareware is also great for customers like you.  You can try 
  50.   out the software before paying for it.  You'll know that a 
  51.   successful shareware product is good, because only satisfied 
  52.   customers pay for it.  The existence of shareware infuses 
  53.   healthy competition in the entire software market, for both 
  54.   price and quality.  In the case of A86, I'm utterly convinced 
  55.   that you'll never find a better value for an assembler, 
  56.   anywhere.
  57.                                                         0-2
  58.  
  59.   Finally, let's consider the distribution houses.  They provide 
  60.   a legitimate service, for which they charge a reasonable price.  
  61.   The best houses act as librarians, evaluating and cataloguing 
  62.   software.  Most pay thousands of dollars for advertising.  
  63.   Their cut is far less than the distributor's cut for 
  64.   "commercial" software (they prosper because their volume is 
  65.   bigger).  Most customers for the distribution houses are repeat 
  66.   customers, who are aware of, and happy with, what they are 
  67.   getting.  If it weren't for your XYZ House, you might never 
  68.   have heard of A86, or might never have figured out where to 
  69.   obtain it. 
  70.  
  71.   So I hope you'll be happy with shareware, and actively desire 
  72.   to support it.  You'll feel good about promoting a healthy 
  73.   situation for everybody.  And you'll encourage the best 
  74.   programmers in the world to keep writing for you, instead of 
  75.   for the big corporations.
  76.  
  77.  
  78. Now that I've said that, let's move on to the package.   The A86 
  79. package consists of the four programs A86.COM, XREF.COM, 
  80. EXMAC.COM, and FAKE.EXE; a collection of source, batch, and 
  81. library files used by the demonstration contained in Chapter 2, 
  82. and a sequence of DOC files that, when printed out in order, make 
  83. the manual.  Each chapter is a DOC file whose name starts with 2 
  84. digits indicating the chapter number.  The files are: 
  85.  
  86. 00README.DOC  (this file)     09DIRC.DOC
  87. 01INTRO.DOC                   10RELOC.DOC
  88. 02DEMO.DOC                    11MACRO.DOC
  89. 03OPREQ.DOC                   12COMPAT.DOC
  90. 04ELEM.DOC                    13TOOLS.DOC
  91. 05EXCLUS.DOC                  14HIST.DOC
  92. 06INSTR.DOC                   15RESERV.DOC
  93. 07FLOAT.DOC                   16INDEX.DOC
  94. 08EXPR.DOC
  95.  
  96.                                                         0-3
  97. TABLE OF CONTENTS
  98.  
  99.  
  100. CHAPTER 1   INTRODUCTION AND LEGAL TERMS
  101.  
  102.   Introduction                             1-1
  103.   Legal Terms and Conditions               1-1
  104.   Overview of A86                          1-3
  105.   Who IS That Guy?                         1-5
  106.   Support Your Local Bulletin Board        1-5
  107.   How to Get in Touch With Me              1-5
  108.  
  109.  
  110. CHAPTER 2   A86 DEMONSTRATION
  111.  
  112.   Demonstration of A86 and Associated Tools                 2-1
  113.   Assembling a Very Short Program: PAGE.COM                 2-1
  114.   Demonstration of Error-Reporting                          2-1
  115.   Assembling a Longer Program with Library Files: REV.COM   2-2
  116.   Using XREF on a medium-sized program: TCOLS.COM           2-2
  117.   Using EXMAC                                               2-3
  118.  
  119.  
  120. CHAPTER 3   OPERATION AND REQUIREMENTS
  121.  
  122.   A86 Program Invocation                    3-1
  123.   Assembler Switches                        3-2
  124.   The A86 Environment Variable              3-3
  125.   Using Standard Input as a Command Tail    3-4
  126.   Strategies for Source File Maintenance    3-4
  127.   System Requirements for A86               3-5
  128.  
  129.  
  130. CHAPTER 4   ELEMENTS OF THE A86 LANGUAGE
  131.  
  132.   The A86 Language and the A86 Program               4-1
  133.   General Categories of A86 Elements                 4-1
  134.   Operand Typing and Code Generation                 4-3
  135.   Registers                                          4-3
  136.   Variables                                          4-3
  137.   Labels                                             4-4
  138.   Constants                                          4-4
  139.   Generating Opcodes from General Purpose Mnemonics  4-4
  140.  
  141.  
  142. CHAPTER 5   SOME EXCLUSIVE FEATURES OF A86
  143.  
  144.   The IF Statement                               5-1
  145.   Multiple operands to PUSH, POP, INC, DEC       5-1
  146.   Conditional Return Instructions                5-2
  147.   A86 extensions to the MOV instruction          5-2
  148.   Local Labels                                   5-2
  149.   Operands to AAM and AAD Instructions           5-3
  150.                                                            0-4
  151. CHAPTER 6    THE 86 INSTRUCTION SET
  152.  
  153.   Effective Addresses                            6-1
  154.   Segmentation and Effective Addresses           6-2
  155.   Effective Use of Effective Addresses           6-3
  156.   Encoding of Effective Addresses                6-4
  157.   Table of Effective Address byte values         6-5
  158.   How to Read the Instruction Set Chart          6-6
  159.   The Instruction Set Chart                      6-7
  160.  
  161.  
  162. CHAPTER 7   THE FLOATING-POINT PROCESSOR
  163.  
  164.   The 8087 and 287 Coprocessors          7-1
  165.   Emulating the 8087 by Software         7-2
  166.   The Floating Point Stack               7-3
  167.   Floating Point Initializations         7-3
  168.   Built-In Constant Names                7-3
  169.   Special Immediate FLD Form             7-4
  170.   Floating Point Operand Types           7-4
  171.   Operand Choices in A86                 7-5
  172.   The 87 Instruction Set                 7-5
  173.  
  174.  
  175. CHAPTER 8   NUMBERS AND EXPRESSIONS
  176.  
  177.   Numbers and Bases                      8-1
  178.   The RADIX Directive                    8-2
  179.   Special Defaults for DT Numbers        8-2
  180.   Floating-point Initializations         8-3
  181.   Overview of Expressions                8-3
  182.   Types of Expression Operands           8-4
  183.   Numbers and Label Addresses            8-4
  184.   Variables                              8-4
  185.   Index Expressions                      8-4
  186.   Arithmetic Operators                   8-4
  187.   HIGH/LOW                               8-4
  188.   BY                                     8-5
  189.   Addition (combination)                 8-5
  190.   Subtraction                            8-6
  191.   Multiplication and Division            8-6
  192.   Shifting Operators                     8-6
  193.   Logical Operators                      8-7
  194.   Relational Operators                   8-7
  195.   Attribute Operators/Specifiers         8-8
  196.   SHORT and LONG operators               8-8
  197.   OFFSET operator                        8-9
  198.   NEAR Operator                          8-9
  199.   Square Brackets Operator              8-10
  200.   Colon Operator                        8-10
  201.   ST Operator                           8-11
  202.   TYPE Operator                         8-11
  203.   THIS and $ Specifiers                 8-11
  204.   Operator Precedence                   8-12
  205.                                                          0-5
  206. CHAPTER 9   DIRECTIVES IN A86
  207.  
  208.   Segments in A86                                 9-1
  209.   CODE ENDS and DATA ENDS Statements              9-2
  210.   The ORG Directive                               9-2
  211.   The EVEN Directive                              9-3
  212.   Data Allocation Using DB, DW, DD, DQ, and DT    9-3
  213.   The STRUC Directive                             9-6
  214.   Forward References                              9-6
  215.   Forward References in Expressions               9-7
  216.   The EQU Directive                               9-8
  217.   Equates to Built-In Symbols                     9-9
  218.   The NIL Prefix                                  9-9
  219.   Interrupt Equates                               9-9
  220.   Duplicate Definitions                          9-10
  221.   The PROC Directive                             9-11
  222.   The ENDP Directive                             9-11
  223.   The LABEL Directive                            9-12
  224.  
  225.  
  226. CHAPTER 10   RELOCATION AND LINKAGE
  227.  
  228.   .OBJ Production Made Easy                          10-1
  229.   Overview of Relocation and Linkage                 10-2
  230.   The NAME Directive                                 10-5
  231.   The PUBLIC Directive                               10-5
  232.   The EXTRN Directive                                10-6
  233.   MAIN: The Starting Location for a Program          10-7
  234.   The END Directive                                  10-7
  235.   The SEGMENT Directive                              10-8
  236.   DATA SEGMENT, STRUC and CODE SEGMENT Directives   10-11
  237.   The ENDS Directive                                10-11
  238.   Default Outer SEGMENT                             10-11
  239.   The GROUP Directive                               10-12
  240.  
  241.  
  242. CHAPTER 11   MACROS AND CONDITIONAL ASSEMBLY
  243.  
  244.   Macro Facility                                     11-1
  245.   Simple Macro Syntax                                11-1
  246.   Formatting in macro definitions and calls          11-2
  247.   Macro operand substitution                         11-2
  248.   Quoted-string operands                             11-3
  249.   Looping by operands in macros                      11-4
  250.   The #L last operator and indefinite repeats        11-5
  251.   Character-loops                                    11-5
  252.   The "B"-before and "A"-after operators             11-6
  253.   Multiple-increments within loops                   11-6
  254.   Negative R-loops                                   11-7
  255.   Nesting of loops in macros                         11-7
  256.   Implied closing of loops                           11-8
  257.   Local labels in macros                             11-8
  258.   Debugging macro expansions                         11-9
  259.                                                             0-6
  260.   Conditional Assembly                              11-10
  261.   Conditional Assembly and Macros                   11-11
  262.   Conditional Assembly and the XREF Program         11-12
  263.   Declaring Variables in the Assembler Invocation   11-13
  264.   Null Invocation Variable Names                    11-13
  265.   Changing Values of Invocation Variables           11-14
  266.  
  267.  
  268. CHAPTER 12   COMPATIBILITY WITH OTHER ASSEMBLERS
  269.  
  270.   Conversion of Intel/IBM/MSDOS programs to A86     12-1
  271.   Compatibility-symbols recognized by A86           12-3
  272.   Conversion of A86 Programs to Intel/IBM/MSDOS     12-3
  273.  
  274.  
  275. CHAPTER 13   ASSOCIATED TOOLS
  276.  
  277.   XREF Cross-reference and Symbol Listing Facility    13-1
  278.   EXMAC Macro Expansion Tool                          13-3
  279.   A86LIB Source File Library Tool                     13-4
  280.   Environment Variable A86LIB                         13-4
  281.   Forcing a Library Search                            13-4
  282.   Listings with A86                                   13-5
  283.   Mimicking Tool: FAKE.EXE                            13-6
  284.  
  285.  
  286. CHAPTER 14   RELEASE HISTORY OF A86
  287.  
  288.  
  289. CHAPTER 15    RESERVED SYMBOLS IN THE A86 LANGUAGE
  290.  
  291.  
  292. INDEX
  293.  
  294.  
  295.